home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / guis / gadutil / docs / autodocs / 28.gu_addtail < prev    next >
Encoding:
Text File  |  1996-07-16  |  1.3 KB  |  43 lines
  1. gadutil.library/GU_AddTail                         gadutil.library/GU_AddTail
  2.  
  3.    NAME
  4.     GU_AddTail -- Add a node to the end of a listview's list.
  5.  
  6.    SYNOPSIS
  7.     node = GU_AddTail(gad, string, list)
  8.     D0, SR (Z)        D0   A0      A1
  9.  
  10.     struct Node *GU_AddTail(struct Gadget *, STRPTR, struct List *);
  11.  
  12.    FUNCTION
  13.     Add a node to the end of a list linked to a gadget (eg. a ListView).
  14.  
  15.     Normally this is used to add a node to a listview list, but it can
  16.     also be used if you eg have another list that that contains
  17.     information about the items in the listview. This list will then
  18.     also be deallocated at the same time as the listview's own list.
  19.     If you do this, be sure to clear the list header of this other list
  20.     when you want to deallocate the list (you can use the GU_NewList
  21.     function).
  22.  
  23.    INPUTS
  24.     gad    - Gadget to keep the nodes in (ie the ListView gadget).
  25.  
  26.     string - String to put in the nodes' LN_NAME field (visible entry).
  27.  
  28.     list   - List to add the node to.
  29.  
  30.    RESULT
  31.     node - Struct Node for success, FALSE for error.
  32.     SR(Z)- 0 for success, 1 for error.
  33.  
  34.    NOTES
  35.     The SR(Z) is probably most usable for assembly programmers.
  36.  
  37.    BUGS
  38.     none known
  39.  
  40.    SEE ALSO
  41.     GU_CountNodes(), GU_NewList(), GU_ClearList(), GU_DetachList(),
  42.     GU_AttachList(), GU_FindNode(), GU_NodeUp(), GU_NodeDown(), GU_SortList()
  43.